<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QDeclarativeEngine Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QDeclarativeEngine Class Reference<br /><sup><sup>[<a href="qtdeclarative.html">QtDeclarative</a> module]</sup></sup></h1><p>The QDeclarativeEngine class provides an environment for
instantiating QML components. <a href="#details">More...</a></p>

<p>Inherits <a href="qobject.html">QObject</a>.</p><h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qdeclarativeengine.html#ObjectOwnership-enum">ObjectOwnership</a></b> { CppOwnership, JavaScriptOwnership }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qdeclarativeengine.html#QDeclarativeEngine">__init__</a></b> (<i>self</i>, QObject&#160;<i>parent</i>&#160;=&#160;None)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#addImageProvider">addImageProvider</a></b> (<i>self</i>, QString&#160;<i>id</i>, QDeclarativeImageProvider)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#addImportPath">addImportPath</a></b> (<i>self</i>, QString&#160;<i>dir</i>)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#addPluginPath">addPluginPath</a></b> (<i>self</i>, QString&#160;<i>dir</i>)</li><li><div class="fn" />QUrl <b><a href="qdeclarativeengine.html#baseUrl">baseUrl</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#clearComponentCache">clearComponentCache</a></b> (<i>self</i>)</li><li><div class="fn" />QDeclarativeImageProvider <b><a href="qdeclarativeengine.html#imageProvider">imageProvider</a></b> (<i>self</i>, QString&#160;<i>id</i>)</li><li><div class="fn" />QStringList <b><a href="qdeclarativeengine.html#importPathList">importPathList</a></b> (<i>self</i>)</li><li><div class="fn" />(bool, QString&#160;<i>errorString</i>) <b><a href="qdeclarativeengine.html#importPlugin">importPlugin</a></b> (<i>self</i>, QString&#160;<i>filePath</i>, QString&#160;<i>uri</i>)</li><li><div class="fn" />QNetworkAccessManager <b><a href="qdeclarativeengine.html#networkAccessManager">networkAccessManager</a></b> (<i>self</i>)</li><li><div class="fn" />QDeclarativeNetworkAccessManagerFactory <b><a href="qdeclarativeengine.html#networkAccessManagerFactory">networkAccessManagerFactory</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qdeclarativeengine.html#offlineStoragePath">offlineStoragePath</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qdeclarativeengine.html#outputWarningsToStandardError">outputWarningsToStandardError</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qdeclarativeengine.html#pluginPathList">pluginPathList</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#removeImageProvider">removeImageProvider</a></b> (<i>self</i>, QString&#160;<i>id</i>)</li><li><div class="fn" />QDeclarativeContext <b><a href="qdeclarativeengine.html#rootContext">rootContext</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setBaseUrl">setBaseUrl</a></b> (<i>self</i>, QUrl)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setImportPathList">setImportPathList</a></b> (<i>self</i>, QStringList&#160;<i>paths</i>)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setNetworkAccessManagerFactory">setNetworkAccessManagerFactory</a></b> (<i>self</i>, QDeclarativeNetworkAccessManagerFactory)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setOfflineStoragePath">setOfflineStoragePath</a></b> (<i>self</i>, QString&#160;<i>dir</i>)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setOutputWarningsToStandardError">setOutputWarningsToStandardError</a></b> (<i>self</i>, bool)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setPluginPathList">setPluginPathList</a></b> (<i>self</i>, QStringList&#160;<i>paths</i>)</li></ul><h3>Static Methods</h3><ul><li><div class="fn" />QDeclarativeContext <b><a href="qdeclarativeengine.html#contextForObject">contextForObject</a></b> (QObject)</li><li><div class="fn" />ObjectOwnership <b><a href="qdeclarativeengine.html#objectOwnership">objectOwnership</a></b> (QObject)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setContextForObject">setContextForObject</a></b> (QObject, QDeclarativeContext)</li><li><div class="fn" /><b><a href="qdeclarativeengine.html#setObjectOwnership">setObjectOwnership</a></b> (QObject, ObjectOwnership)</li></ul><h3>Qt Signals</h3><ul><li><div class="fn" />void <b><a href="qdeclarativeengine.html#quit">quit</a></b> ()</li><li><div class="fn" />void <b><a href="qdeclarativeengine.html#warnings">warnings</a></b> (const QList&lt;QDeclarativeError&gt;&amp;)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QDeclarativeEngine class provides an environment for
instantiating QML components.</p>
<p>Each QML component is instantiated in a <a href="qdeclarativecontext.html">QDeclarativeContext</a>. <a href="qdeclarativecontext.html">QDeclarativeContext</a>'s are essential
for passing data to QML components. In QML, contexts are arranged
hierarchically and this hierarchy is managed by the
QDeclarativeEngine.</p>
<p>Prior to creating any QML components, an application must have
created a QDeclarativeEngine to gain access to a QML context. The
following example shows how to create a simple Text item.</p>
<pre class="cpp">
 <span class="type">QDeclarativeEngine</span> engine;
 <span class="type"><a href="qdeclarativecomponent.html">QDeclarativeComponent</a></span> component(<span class="operator">&amp;</span>engine);
 component<span class="operator">.</span>setData(<span class="string">"import QtQuick 1.0\nText { text: \"Hello world!\" }"</span><span class="operator">,</span> <span class="type"><a href="qurl.html">QUrl</a></span>());
 <span class="type"><a href="qdeclarativeitem.html">QDeclarativeItem</a></span> <span class="operator">*</span>item <span class="operator">=</span> qobject_cast<span class="operator">&lt;</span><span class="type"><a href="qdeclarativeitem.html">QDeclarativeItem</a></span> <span class="operator">*</span><span class="operator">&gt;</span>(component<span class="operator">.</span>create());

 <span class="comment">//add item to view, etc</span>
 <span class="operator">.</span><span class="operator">.</span><span class="operator">.</span>
</pre>
<p>In this case, the Text item will be created in the engine's
<a href="qdeclarativeengine.html#rootContext">root context</a>.</p>
<hr /><h2>Type Documentation</h2><h3 class="fn"><a name="ObjectOwnership-enum" />QDeclarativeEngine.ObjectOwnership</h3><p>Ownership controls whether or not QML automatically destroys the
<a href="qobject.html">QObject</a> when the object is garbage
collected by the JavaScript engine. The two ownership options
are:</p>
<table class="valuelist">
<tr class="odd" valign="top">
<th class="tblConst">Constant</th>
<th class="tblval">Value</th>
<th class="tbldscr">Description</th>
</tr>
<tr>
<td class="topAlign"><tt>QDeclarativeEngine.CppOwnership</tt></td>
<td class="topAlign"><tt>0</tt></td>
<td class="topAlign">The object is owned by C++ code, and will
never be deleted by QML. The JavaScript destroy() method cannot be
used on objects with CppOwnership. This option is similar to
<a href="qscriptengine.html#ValueOwnership-enum">QScriptEngine.QtOwnership</a>.</td>
</tr>
<tr>
<td class="topAlign">
<tt>QDeclarativeEngine.JavaScriptOwnership</tt></td>
<td class="topAlign"><tt>1</tt></td>
<td class="topAlign">The object is owned by JavaScript. When the
object is returned to QML as the return value of a method call or
property access, QML will delete the object if there are no
remaining JavaScript references to it and it has no <a href="qobject.html#parent">QObject.parent</a>(). This option is similar
to <a href="qscriptengine.html#ValueOwnership-enum">QScriptEngine.ScriptOwnership</a>.</td>
</tr>
</table>
<p>Generally an application doesn't need to set an object's
ownership explicitly. QML uses a heuristic to set the default
object ownership. By default, an object that is created by QML has
JavaScriptOwnership. The exception to this are the root objects
created by calling QDeclarativeCompnent.create() or <a href="qdeclarativecomponent.html#beginCreate">QDeclarativeComponent.beginCreate</a>()
which have CppOwnership by default. The ownership of these
root-level objects is considered to have been transferred to the
C++ caller.</p>
<p>Objects not-created by QML have CppOwnership by default. The
exception to this is objects returned from a C++ method call. The
ownership of these objects is passed to JavaScript.</p>
<p>Calling <a href="qdeclarativeengine.html#setObjectOwnership">setObjectOwnership</a>()
overrides the default ownership heuristic used by QML.</p>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QDeclarativeEngine" />QDeclarativeEngine.__init__ (<i>self</i>, <a href="qobject.html">QObject</a>&#160;<i>parent</i>&#160;=&#160;None)</h3><p>The <i>parent</i> argument, if not None, causes <i>self</i> to be owned by Qt instead of PyQt.</p><p>Create a new <a href="qdeclarativeengine.html">QDeclarativeEngine</a> with the given
<i>parent</i>.</p>


<h3 class="fn"><a name="addImageProvider" />QDeclarativeEngine.addImageProvider (<i>self</i>, QString&#160;<i>id</i>, <a href="qdeclarativeimageprovider.html">QDeclarativeImageProvider</a>)</h3><p>Sets the <i>provider</i> to use for images requested via the
<i>image</i>: url scheme, with host <i>providerId</i>. The <a href="qdeclarativeengine.html">QDeclarativeEngine</a> takes ownership of
<i>provider</i>.</p>
<p>Image providers enable support for pixmap and threaded image
requests. See the <a href="qdeclarativeimageprovider.html">QDeclarativeImageProvider</a>
documentation for details on implementing and using image
providers.</p>
<p>All required image providers should be added to the engine
before any QML sources files are loaded.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#removeImageProvider">removeImageProvider</a>().</p>


<h3 class="fn"><a name="addImportPath" />QDeclarativeEngine.addImportPath (<i>self</i>, QString&#160;<i>dir</i>)</h3><p>Adds <i>path</i> as a directory where the engine searches for
installed modules in a URL-based directory structure. The
<i>path</i> may be a local filesystem directory or a URL.</p>
<p>The newly added <i>path</i> will be first in the <a href="qdeclarativeengine.html#importPathList">importPathList</a>().</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setImportPathList">setImportPathList</a>()
and <a href="qdeclarativemodules.html#qml-modules">QML
Modules</a>.</p>


<h3 class="fn"><a name="addPluginPath" />QDeclarativeEngine.addPluginPath (<i>self</i>, QString&#160;<i>dir</i>)</h3><p>Adds <i>path</i> as a directory where the engine searches for
native plugins for imported modules (referenced in the
<tt>qmldir</tt> file).</p>
<p>By default, the list contains only <tt>.</tt>, i.e. the engine
searches in the directory of the <tt>qmldir</tt> file itself.</p>
<p>The newly added <i>path</i> will be first in the <a href="qdeclarativeengine.html#pluginPathList">pluginPathList</a>().</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setPluginPathList">setPluginPathList</a>().</p>


<h3 class="fn"><a name="baseUrl" /><a href="qurl.html">QUrl</a> QDeclarativeEngine.baseUrl (<i>self</i>)</h3><p>Return the base URL for this engine. The base URL is only used
to resolve components when a relative URL is passed to the <a href="qdeclarativecomponent.html">QDeclarativeComponent</a>
constructor.</p>
<p>If a base URL has not been explicitly set, this method returns
the application's current working directory.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setBaseUrl">setBaseUrl</a>().</p>


<h3 class="fn"><a name="clearComponentCache" />QDeclarativeEngine.clearComponentCache (<i>self</i>)</h3><p>Clears the engine's internal component cache.</p>
<p>Normally the <a href="qdeclarativeengine.html">QDeclarativeEngine</a> caches components
loaded from qml files. This method clears this cache and forces the
component to be reloaded.</p>


<h3 class="fn"><a name="contextForObject" /><a href="qdeclarativecontext.html">QDeclarativeContext</a> QDeclarativeEngine.contextForObject (<a href="qobject.html">QObject</a>)</h3><p>Returns the <a href="qdeclarativecontext.html">QDeclarativeContext</a> for the
<i>object</i>, or 0 if no context has been set.</p>
<p>When the <a href="qdeclarativeengine.html">QDeclarativeEngine</a> instantiates a
<a href="qobject.html">QObject</a>, the context is set
automatically.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setContextForObject">setContextForObject</a>().</p>


<h3 class="fn"><a name="imageProvider" /><a href="qdeclarativeimageprovider.html">QDeclarativeImageProvider</a> QDeclarativeEngine.imageProvider (<i>self</i>, QString&#160;<i>id</i>)</h3><p>Returns the <a href="qdeclarativeimageprovider.html">QDeclarativeImageProvider</a> set
for <i>providerId</i>.</p>


<h3 class="fn"><a name="importPathList" />QStringList QDeclarativeEngine.importPathList (<i>self</i>)</h3><p>Returns the list of directories where the engine searches for
installed modules in a URL-based directory structure.</p>
<p>For example, if <tt>/opt/MyApp/lib/imports</tt> is in the path,
then QML that imports <tt>com.mycompany.Feature</tt> will cause the
<a href="qdeclarativeengine.html">QDeclarativeEngine</a> to look in
<tt>/opt/MyApp/lib/imports/com/mycompany/Feature/</tt> for the
components provided by that module. A <tt>qmldir</tt> file is
required for defining the type version mapping and possibly
declarative extensions plugins.</p>
<p>By default, the list contains the directory of the application
executable, paths specified in the <tt>QML_IMPORT_PATH</tt>
environment variable, and the builtin <tt>ImportsPath</tt> from
<a href="qlibraryinfo.html">QLibraryInfo</a>.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#addImportPath">addImportPath</a>() and
<a href="qdeclarativeengine.html#setImportPathList">setImportPathList</a>().</p>


<h3 class="fn"><a name="importPlugin" />(bool, QString&#160;<i>errorString</i>) QDeclarativeEngine.importPlugin (<i>self</i>, QString&#160;<i>filePath</i>, QString&#160;<i>uri</i>)</h3><p>Imports the plugin named <i>filePath</i> with the <i>uri</i>
provided. Returns true if the plugin was successfully imported;
otherwise returns false.</p>
<p>On failure and if non-null, *<i>errorString</i> will be set to a
message describing the failure.</p>
<p>The plugin has to be a Qt plugin which implements the <a href="qdeclarativeextensionplugin.html">QDeclarativeExtensionPlugin</a>
interface.</p>


<h3 class="fn"><a name="networkAccessManager" /><a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> QDeclarativeEngine.networkAccessManager (<i>self</i>)</h3><p>Returns a common <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> which can be
used by any QML element instantiated by this engine.</p>
<p>If a <a href="qdeclarativenetworkaccessmanagerfactory.html">QDeclarativeNetworkAccessManagerFactory</a>
has been set and a <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> has not yet
been created, the <a href="qdeclarativenetworkaccessmanagerfactory.html">QDeclarativeNetworkAccessManagerFactory</a>
will be used to create the <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>; otherwise
the returned <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> will have no
proxy or cache set.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setNetworkAccessManagerFactory">setNetworkAccessManagerFactory</a>().</p>


<h3 class="fn"><a name="networkAccessManagerFactory" /><a href="qdeclarativenetworkaccessmanagerfactory.html">QDeclarativeNetworkAccessManagerFactory</a> QDeclarativeEngine.networkAccessManagerFactory (<i>self</i>)</h3><p>Returns the current <a href="qdeclarativenetworkaccessmanagerfactory.html">QDeclarativeNetworkAccessManagerFactory</a>.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setNetworkAccessManagerFactory">setNetworkAccessManagerFactory</a>().</p>


<h3 class="fn"><a name="objectOwnership" /><a href="qdeclarativeengine.html#ObjectOwnership-enum">ObjectOwnership</a> QDeclarativeEngine.objectOwnership (<a href="qobject.html">QObject</a>)</h3><p>Returns the ownership of <i>object</i>.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setObjectOwnership">setObjectOwnership</a>().</p>


<h3 class="fn"><a name="offlineStoragePath" />QString QDeclarativeEngine.offlineStoragePath (<i>self</i>)</h3><h3 class="fn"><a name="outputWarningsToStandardError" />bool QDeclarativeEngine.outputWarningsToStandardError (<i>self</i>)</h3><p>Returns true if warning messages will be output to stderr in
addition to being emitted by the <a href="qdeclarativeengine.html#warnings">warnings</a>() signal, otherwise
false.</p>
<p>The default value is true.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#setOutputWarningsToStandardError">setOutputWarningsToStandardError</a>().</p>


<h3 class="fn"><a name="pluginPathList" />QStringList QDeclarativeEngine.pluginPathList (<i>self</i>)</h3><p>Returns the list of directories where the engine searches for
native plugins for imported modules (referenced in the
<tt>qmldir</tt> file).</p>
<p>By default, the list contains only <tt>.</tt>, i.e. the engine
searches in the directory of the <tt>qmldir</tt> file itself.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#addPluginPath">addPluginPath</a>() and
<a href="qdeclarativeengine.html#setPluginPathList">setPluginPathList</a>().</p>


<h3 class="fn"><a name="removeImageProvider" />QDeclarativeEngine.removeImageProvider (<i>self</i>, QString&#160;<i>id</i>)</h3><p>Removes the <a href="qdeclarativeimageprovider.html">QDeclarativeImageProvider</a> for
<i>providerId</i>.</p>
<p>Returns the provider if it was found; otherwise returns 0.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#addImageProvider">addImageProvider</a>().</p>


<h3 class="fn"><a name="rootContext" /><a href="qdeclarativecontext.html">QDeclarativeContext</a> QDeclarativeEngine.rootContext (<i>self</i>)</h3><p>Returns the engine's root context.</p>
<p>The root context is automatically created by the <a href="qdeclarativeengine.html">QDeclarativeEngine</a>. Data that should
be available to all QML component instances instantiated by the
engine should be put in the root context.</p>
<p>Additional data that should only be available to a subset of
component instances should be added to sub-contexts parented to the
root context.</p>


<h3 class="fn"><a name="setBaseUrl" />QDeclarativeEngine.setBaseUrl (<i>self</i>, <a href="qurl.html">QUrl</a>)</h3><p>Set the base URL for this engine to <i>url</i>.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#baseUrl">baseUrl</a>().</p>


<h3 class="fn"><a name="setContextForObject" />QDeclarativeEngine.setContextForObject (<a href="qobject.html">QObject</a>, <a href="qdeclarativecontext.html">QDeclarativeContext</a>)</h3><p>Sets the <a href="qdeclarativecontext.html">QDeclarativeContext</a> for the
<i>object</i> to <i>context</i>. If the <i>object</i> already has a
context, a warning is output, but the context is not changed.</p>
<p>When the <a href="qdeclarativeengine.html">QDeclarativeEngine</a> instantiates a
<a href="qobject.html">QObject</a>, the context is set
automatically.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#contextForObject">contextForObject</a>().</p>


<h3 class="fn"><a name="setImportPathList" />QDeclarativeEngine.setImportPathList (<i>self</i>, QStringList&#160;<i>paths</i>)</h3><p>Sets <i>paths</i> as the list of directories where the engine
searches for installed modules in a URL-based directory
structure.</p>
<p>By default, the list contains the directory of the application
executable, paths specified in the <tt>QML_IMPORT_PATH</tt>
environment variable, and the builtin <tt>ImportsPath</tt> from
<a href="qlibraryinfo.html">QLibraryInfo</a>.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#importPathList">importPathList</a>() and
<a href="qdeclarativeengine.html#addImportPath">addImportPath</a>().</p>


<h3 class="fn"><a name="setNetworkAccessManagerFactory" />QDeclarativeEngine.setNetworkAccessManagerFactory (<i>self</i>, <a href="qdeclarativenetworkaccessmanagerfactory.html">QDeclarativeNetworkAccessManagerFactory</a>)</h3><p>Sets the <i>factory</i> to use for creating <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>(s).</p>
<p><a href="qnetworkaccessmanager.html">QNetworkAccessManager</a>
is used for all network access by QML. By implementing a factory it
is possible to create custom <a href="qnetworkaccessmanager.html">QNetworkAccessManager</a> with
specialized caching, proxy and cookie support.</p>
<p>The factory must be set before executing the engine.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#networkAccessManagerFactory">networkAccessManagerFactory</a>().</p>


<h3 class="fn"><a name="setObjectOwnership" />QDeclarativeEngine.setObjectOwnership (<a href="qobject.html">QObject</a>, <a href="qdeclarativeengine.html#ObjectOwnership-enum">ObjectOwnership</a>)</h3><p>Sets the <i>ownership</i> of <i>object</i>.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#objectOwnership">objectOwnership</a>().</p>


<h3 class="fn"><a name="setOfflineStoragePath" />QDeclarativeEngine.setOfflineStoragePath (<i>self</i>, QString&#160;<i>dir</i>)</h3><h3 class="fn"><a name="setOutputWarningsToStandardError" />QDeclarativeEngine.setOutputWarningsToStandardError (<i>self</i>, bool)</h3><p>Set whether warning messages will be output to stderr to
<i>enabled</i>.</p>
<p>If <i>enabled</i> is true, any warning messages generated by QML
will be output to stderr and emitted by the <a href="qdeclarativeengine.html#warnings">warnings</a>() signal. If
<i>enabled</i> is false, on the <a href="qdeclarativeengine.html#warnings">warnings</a>() signal will be
emitted. This allows applications to handle warning output
themselves.</p>
<p>The default value is true.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#outputWarningsToStandardError">outputWarningsToStandardError</a>().</p>


<h3 class="fn"><a name="setPluginPathList" />QDeclarativeEngine.setPluginPathList (<i>self</i>, QStringList&#160;<i>paths</i>)</h3><p>Sets the list of directories where the engine searches for
native plugins for imported modules (referenced in the
<tt>qmldir</tt> file) to <i>paths</i>.</p>
<p>By default, the list contains only <tt>.</tt>, i.e. the engine
searches in the directory of the <tt>qmldir</tt> file itself.</p>
<p><b>See also</b> <a href="qdeclarativeengine.html#pluginPathList">pluginPathList</a>() and
<a href="qdeclarativeengine.html#addPluginPath">addPluginPath</a>().</p>


<hr /><h2>Qt Signal Documentation</h2><h3 class="fn"><a name="quit" />void quit ()</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when the QML loaded by the engine would
like to quit.</p>


<h3 class="fn"><a name="warnings" />void warnings (const QList&lt;QDeclarativeError&gt;&amp;)</h3><p>This is the default overload of this signal.</p><p>This signal is emitted when <i>warnings</i> messages are
generated by QML.</p>
<address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt&#160;snapshot-4.9.5-9eb6aac99275 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt&#160;4.8.3</td></tr></table></div></address></body></html>